命令永不停止的控制運動在有最大距離限制下以指定速度移動，當軸到達最大距離時將會自動停止。
語法
KsCommandStatus InchGroup(
int Index,
int Length,
double* Distance,
double* Velocity,
double Acceleration,
double Deceleration,
double Jerk,
McCoordSystem CoordSystem
);參數
Index [in]：軸組索引，索引以零為起點。最多可有 32 個軸組。
Length [in]： 距離 (Distance) 或速度 (Velocity) 的長度，兩者長度相同。
Distance [in]：此運動移動的最大距離。
Velocity [in]：指定速度的值，[單位/秒]。
Acceleration [in]：加速度值，單位由 McProfileType 類型決定，（馬達的增加能源） [單位/秒2] 或 [秒]。
Deceleration [in]：減速度值，單位由 McProfileType 類型決定，（馬達的減少能源） [單位/秒2] 或 [秒]。
Jerk [in]：加加速度值，單位由 McProfileType 類型決定，為 [單位/秒3] 或 [秒]。
CoordSystem [in]：座標系統，僅支援 ACS。請見 McCoordSystem 類型。
回傳值
返回 KsCommandStatus 結構。
備註
- Velocity、Acceleration、Deceleration 與 Jerk 為組內各軸設定值，而非路徑值，若其中之參數值（如 Acceleration）超過組內之一軸的最大 Acceleration，該軸將使用自己的最大 Acceleration 值，而其他軸使用提供的值。
- Velocity 與 Distance 可在軸組運行時修改。
- Distance 陣列的元素必須大於零 (> 0)，也就是說每一軸移動的距離皆大於零 (> 0)。
- InchGroup 僅可於 GroupStandstill 狀態中使用。
- 若組中的一個軸完成了移動而其他軸還未完成，欲維持該軸移動，有兩種選擇：
- 增加距離。此軸將在另一個移動中移動增加的部分，例如將距離從 2000 改為 2500，軸將在移動 2000 單位後移動 500 單位。
- 改變該軸速度。軸將使用新的速度行駛當前的距離。
重要：若距離很短且速度很快，則軸的“煞停距離”可能會超過指定的距離，這可能會導致軸故障。
範例
N/A使用需求
| RT | Win32 | |
|---|---|---|
| 最低支援版本 | 4.0 | 4.0 |
| 標頭檔 | ksmotion.h | ksmotion.h |
| 程式庫 | KsApi_Rtss.lib | KsApi.lib |
參見